home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 65.zip / BS1 part 65 / Protracker v2.1a.adf / PT.help.txt < prev    next >
Text File  |  1992-04-14  |  52KB  |  1,659 lines

  1. -------------------------------------------------------------------------
  2. Protracker V2.1 Release A - (C) 1992 Mushroom Studios / Noxious 17/4-1992
  3. -------------------------------------------------------------------------
  4.  
  5. Protracker is a Public Domain program, and may may be copied freely and
  6. included in any PD library. You may not charge anything for the program
  7. other than the cost of the disk and the PD-service.
  8.  
  9. *** This is an printable version of the PT.help file ***
  10.  
  11.     Written by:  Lars "ZAP" Hamre, UPDATED by Peter "CRAYON" Hanning
  12.  Layout & Help:  Anders "Dolphin" Ramsay
  13.  
  14.  Thanks must go to the following for contributing with suggestions and
  15.  bug-reports: Gahn, Reverend D, Dolphin, all members of Noxious.
  16.  
  17.  Hi there!
  18.  
  19.  Here comes PT2.1A, a new version of Protracker, the best tracker around!
  20.  
  21.  There has been several new changes this time to enhance Protracker even
  22.  more! Read more about it in the Readme!.txt file.
  23.  Don't hesitate to contact us if you can't get it working, if there's some-
  24.  thing you can't figure out or if you find any bugs.
  25.  
  26.  Some technical info:
  27.  
  28.    Sourcecode: 387k / 22000 lines
  29.  Main Program: 170k
  30.      GFX data: 66k (packed)
  31.      Worktime: 954541497 hours
  32.      ASM time: about 22 seconds
  33.  
  34.  Something you'd like in the next version of Protracker? Have you found
  35.  any bugs?
  36.  
  37.           Anyway, write to:
  38.  
  39.           Mushroom Studios/Noxious
  40.           Vinterstigen 12
  41.           14440 Ronninge
  42.           Sweden
  43.  
  44.          (No games, please!)
  45.  
  46.  Mushroom Studios are (a subgroup of NOXIOUS):
  47.  
  48.  Peter "CRAYON" Hanning         (Coder,Musician)
  49.  Anders "DOLPHIN" Ramsay        (Musician,Organizer)
  50.  
  51.  
  52.  Planned release date for PT 2.2:  Somewhere in time. We'll be back!
  53.  
  54.  
  55.  
  56.                 MAINSCREEN
  57.                 ----------
  58.  ## PLAY ##
  59.  Will play the song from the current position in the song. The pointer
  60.  turns yellow, just to show you what's going on.
  61.  
  62.  ## PATTERN ##
  63.  Will play the current pattern which is shown at the bottom of the screen.
  64.  The pointer turns yellow here as well. Holding down the right button while
  65.  pressing play,pattern or record will play from the current patternposition.
  66.  
  67.  ## EDIT ##
  68.  Will put you in edit mode. The pointer turns blue, and you can enter notes
  69.  and numbers from the keyboard. Use the arrowkeys to move up/down and
  70.  left/right in the pattern. Entering a note or a number will cause the
  71.  pattern to jump one or more slots down.
  72.  
  73.  ## RECORD ##
  74.  Will put you in edit mode, but also play the current pattern or song.
  75.  You can select this in the Edit Options menu. While the pattern or
  76.  song is playing, you can type in notes and numbers from the keyboard,
  77.  and they will appear in the pattern as it scrolls. The notes and numbers
  78.  will also be quantized to the nearest slot, so that keeping a steady rhythm
  79.  is no problem. The pointer will turn blue here as well as in the the normal
  80.  edit mode.
  81.  
  82.  ## STOP ##
  83.  Will stop playing of songs and patterns, recording, and will turn edit
  84.  mode off.
  85.  
  86.  ## CLEAR ##
  87.  Will first ask you what you want to clear. You can clear either all,
  88.  song or samples.
  89.  
  90.  ## EDIT OP. ##
  91.  Will exchange the Spectrum Analyzer with the Edit Menu(s). Pressing more
  92.  than one time will browse through the edit op. screens.
  93.  
  94.  ## DISK OP. ##
  95.  Will go to the File Requester.
  96.  
  97.  ## PLST ##
  98.  Will go to the PLST screen.
  99.  
  100.  ## PSET-ED ##
  101.  Will go to the preset editor.
  102.  
  103.  ## SETUP ##
  104.  Will go to the Setup Screen.
  105.  
  106.  ## SAMPLER ##
  107.  Will go to the Sampler screen.
  108.  
  109.  ## 1, 2, 3 and 4 ##
  110.  Represent the audiochannels of your amiga. When lit, that channel is on.
  111.  When not lit, the channel is muted and and the notes in that track will
  112.  not be played.Holding the right mousebutton will solo the desired channel.
  113.  
  114.  ## TEMPO ##
  115.  The tempo gadget on the status bar is for setting the CIA speed, if CIA
  116.  timing is used. The gadget will be updated every time you set the speed
  117.  using the F command (if CIA that is).
  118.  
  119.  ## I(NSERT) ##
  120.  Insert a position into your song.
  121.  
  122.  ## D(ELETE) ##
  123.  Delete a position from your song.
  124.  
  125.  ## POS ##
  126.  Defines your position in the song-table.
  127.  
  128.  ## PATTERN ##
  129.  Defines which pattern will be played at a specific position.
  130.  
  131.  ## LENGTH ## (SONG)
  132.  Defines the length of the song.
  133.  
  134.  ## FINETUNE ##
  135.  Tune your untuned samples to match the others.
  136.  
  137.      0 436.4 hz    -1 432.1 hz
  138.      1 439.0 hz    -2 429.6 hz
  139.      2 441.6 hz    -3 426.3 hz
  140.      3 445.1 hz    -4 423.1 hz
  141.      4 447.8 hz    -5 419.9 hz
  142.      5 451.5 hz    -6 416.7 hz
  143.      6 455.2 hz    -7 414.4 hz
  144.      7 457.0 hz    -8 412.0 hz
  145.  
  146.  ## SAMPLE ##
  147.  Choose sample. You can use up to 31, or hex $1F samples in a song.
  148.  Pressing both mousebuttons at the same time will set the samplenumber
  149.  to zero. You can then record the pattern with sample 0 to prevent
  150.  Protracker from setting the volume each time you play a new note.
  151.  
  152.  ## LENGTH ## (SAMPLE)
  153.  The Length gadgets are simply used for setting the length of the sample.
  154.  A sample can be up to 64k, or $fffe long. You can add workspace behind
  155.  the sample by increasing the length and letting go of the button. PT will
  156.  ask if you are sure, and if you are, allocate more memory for the sample.
  157.  
  158.  ## VOLUME ##
  159.  Use this to set the volume the current sample will be played with.
  160.  
  161.  ## REPEAT ##
  162.  Here you set the start of the sampleloop.
  163.  
  164.  ## REPLEN ##
  165.  Here you set the length of the sampleloop.
  166.  
  167.  ## PATTERNNUMBER GADGET ##
  168.  To the middle left of the screen is a box with a number in it. The number
  169.  is the current pattern number. Click on it to type in a new number. When
  170.  in type-in mode, use return, ESC or right mousebutton to exit. This should
  171.  also work on most other such gadgets.
  172.  
  173.  ## A(BOUT) ##
  174.  This one you'll have to experience for yourself.
  175.  
  176.  ## LOAD ## (sample)
  177.  Will simply try to load the current samplename. Use this when you've
  178.  fucked up in the sample editor, and have destroyed a sample.
  179.  
  180.  Pressing both the left and right button on the arrow-gadgets will speed
  181.  them up a bit.
  182.  All numbergadgets except Finetune&Sample allows you to click in the
  183.  gadget and type in the desired value.Holding the right mousebutton while
  184.  pressing them will zero the value.
  185.  
  186.  The main screen has some indicators on the left side of the song- and
  187.  samplename textgadgets.The indicators are as follows:
  188.  M S M 0-9 (Metronome ON, Split keyboard ON, Multi keyboard ON, Editskip)
  189.  I 0-9     (AutoInsert ON, AutoInsert Macro)
  190.  
  191.  
  192.  
  193.                 DISK OP.1
  194.                 ---------
  195.  
  196.  ## PATH ##
  197.  The paths for songs, modules, samples, tracks and patterns can now be
  198.  changed, and they can be up to 31 characters long. To change path, click
  199.  on load song/module/sample/track/pattern or use the arrow indicating
  200.  what path you're at.
  201.  
  202.  ## FREE (DISKSPACE) ##
  203.  Free diskspace can be shown in hex or decimal. Select this on the setup
  204.  screen. Click on "free" to get free diskspace without re-reading the dir.
  205.  
  206.  ## FORMAT DISK ##
  207.  Will format a disk in df0: (Hopefully bug-free)
  208.  
  209.  ## RENAME FILE ##
  210.  Will dir the current directory. Select a filename, and you will be able
  211.  to edit the name.
  212.  
  213.  ## DELETE FILE ##
  214.  Will dir the current directory. Select a file, and it will be deleted
  215.  from the disk.
  216.  
  217.  ## PACK ##
  218.  When on, Protracker will pack songs before saving.
  219.  Modules will be PowerPacked and .pp will be added to the filename.
  220.  
  221.  ## LOAD SONG ##
  222.  Will dir the songs path. Select a song, and it will be loaded and
  223.  decrunched if crunched.
  224.  
  225.  ## SAVE SONG ##
  226.  Will pack the song if pack is on, then save it to the current songs
  227.  path. Remember to enter a name for your song, otherwise PT will not save!
  228.  
  229.  ## LOAD MODULE ##
  230.  Will dir the modules path. Select a module, and it will be loaded.
  231.  Powerpacked modules will be decrunched.
  232.  
  233.  ## SAVE MODULE ##
  234.  Will crunch(Powerpacker) the module if pack is on,then save it to the
  235.  current modules path. Modules can be saved without a name, since they
  236.  always begin with "Mod.".Holding the right button will save an icon
  237.  in the "PTpath"/Icons/ directory.
  238.  
  239.  ## LOAD SAMPLE ##
  240.  Will dir the sample path. Select a sample, and it will be loaded to the
  241.  current sample. IFF headers will be chopped off and loops loaded, if any.
  242.  Powerpacked samples will be loaded and decrunched.
  243.  
  244.  ## SAVE SAMPLE ##
  245.  Will save the current sample as RAW, IFF or PAK(Powerpacked). Select
  246.  this in the "Save" gadget to the right of "Load Sample". IFF loops will
  247.  be saved too(Not with PAK in this version).
  248.  
  249.  ## DIR-BROWSE BUTTON ##
  250.  By pressing this button you can browse through various preset paths, so
  251.  that you won't have to enter them over and over again.
  252.  
  253.  ## PATH INDICATOR ##
  254.  Click to change paths without reading dir.
  255.  
  256.  ## 2 ##
  257.  Goto Disk Op.2
  258.  
  259.  ## T(OP) ##
  260.  Will put you at the top of the file-list.Holding the right mousebutton
  261.  will put you at the previous character in the file-list.Try it out!
  262.  
  263.  ## B(OTTOM) ##
  264.  Will put you at the bottom of the file-list.Holding the right mousebutton
  265.  will put you at the next character in the file-list.
  266.  
  267.  
  268.                 DISK OP.2
  269.                 ---------
  270.  Disk op.2 has alot in common with disk op.1 but with a few additional
  271.  features.
  272.  
  273.  ## LOAD TRACK ##
  274.  Will dir the track path. Select a track, and it will be loaded to the
  275.  cursor position or to the trackbuffer, depending on the MODE choice.
  276.  
  277.  ## SAVE TRACK ##
  278.  Will save the track from the cursor position or from the trackbuffer.
  279.  
  280.  ## LOAD PATTERN ##
  281.  Will dir the pattern path. Select a pattern, and it will be loaded to
  282.  the cursor position or to the patternbuffer.
  283.  
  284.  ## SAVE PATTERN ##
  285.  Will save the pattern from the cursor position or from the patternbuffer.
  286.  
  287.  ## MODE ##
  288.  Determines if the track/pattern will load/save to/from the buffer or
  289.  the cursor position.
  290.  
  291.  ## 1 ##
  292.  Goto Disk Op.1
  293.  
  294.  
  295.  AutoDir - If you set the autodir toggle on the setup screen
  296.            to on, Protracker will automatically dir the current
  297.            path when you enter the disk op. screen and after you've
  298.            saved/renamed/deleted something.
  299.  
  300.  AutoExit - When this toggle is on Protracker will exit from
  301.             disk op. when loading a song/module/track or pattern.
  302.  
  303.  
  304.  
  305.                 PLST
  306.                 ----
  307.  The PLST is fairly simple to use. Listed here are all the samples in
  308.  your Presetlist and their lengths. Just click on a name, and Protracker
  309.  will ask for a disk called ST-01 through to ST-FF. Insert it, and the
  310.  chosen sample will be loaded to the current sample displayed at the
  311.  left of the screen. Use the up/down arrow keys to move up and down in the
  312.  PresetList. If you press shift or the right mousebutton, the PLST will
  313.  move 10 presets at a time.
  314.  
  315.  At the top the PLST shows the total number of samples from the selected
  316.  sounddisks. There are a few PLST gadgets:
  317.  
  318.  ## CLEAR ##
  319.  Will clear all the sounddisk names you have entered, and display the whole
  320.  PresetList.
  321.  
  322.  ## MOUNTL(IST) ##
  323.  Will search your drives for disks called ST-**, and put the names into
  324.  the ST-__ gadgets. ST-00 will not be mounted.
  325.  
  326.  ## ST-__ ##
  327.  There are three ST-__ gadgets where you can enter the numbers of the
  328.  sounddisks you want to display in the PLST. Only the presets from the
  329.  selected sounddisks will be shown. If you clear all gadgets (by pressing
  330.  return or right mousebutton), or press "Clear", the PLST will revert
  331.  to show all presets.
  332.  
  333.  ## T(OP) ##
  334.  Will put you at the top of the preset-list.Holding the right mousebutton
  335.  will put you at the previous character in the preset-list.
  336.  
  337.  ## B(OTTOM) ##
  338.  Will put you at the bottom of the preset-list.Holding the right mousebutton
  339.  will put you at the next character in the preset-list.
  340.  
  341.  ## EXIT ##
  342.  There are 2 exitgadgets in this version. I didn't know what to change the
  343.  other exitgadget to.
  344.  
  345.  
  346.  
  347.                 PRESET ED
  348.                 ---------
  349.  The preset editor is used for sorting and catalogueing your samples. All
  350.  samples for use with Protracker should be on disks called "ST-01" to
  351.  "ST-FF". When adding a disk to the presetlist, only these disks are
  352.  recognized.
  353.  
  354.  Harddisk owners may want to add a directory. e.g. You've got a directory
  355.  called "Supersamples", and you want to use the samples on PT... Simple.
  356.  Assign "Supersamples" to ST-13 or whatever. In the box with "Disk:"
  357.  and ST-__ in it, enter ST-13. Now enter "DHX:supersamples" in the
  358.  path box and press "add path".
  359.  
  360.  The path will be added as ST-13 in your presetlist, so everytime you need
  361.  a sample from ST-13, it will be loaded from "Supersamples" instead. Simple?
  362.  
  363.  Editing
  364.  --------
  365.  To edit a preset, simply click on it. Use the arrowkeys to move left/right.
  366.  When moving up and down in the presetlist, use shift or the right mouse-
  367.  button to speed it up a bit.
  368.  
  369.  ## ADD PATH ##
  370.  Will add the current path to the presetlist. infofiles will not be added.
  371.  Samplenames can only be 15 chars long.
  372.  
  373.  ## INSERT PRESET ##
  374.  Will create a new preset. Enter the data for the sample, and it will be
  375.  added to the presetlist.
  376.  
  377.  ## DELETE PRESET ##
  378.  Will delete the wanted preset from the presetlist.
  379.  
  380.  ## DELETE DISK ##
  381.  Will delete the disknumber set in the "Disk:" box.
  382.  
  383.  ## PATH ##
  384.  This is where you enter the path to be added from. It can be up to 31
  385.  characters long.
  386.  
  387.  ## DISK ##
  388.  This is the disk (or HD-dir) that's being added from (or deleted).
  389.  
  390.  ## PRESETS ##
  391.  This is the current number of presets in the presetlist.
  392.  
  393.  ## CLEAR PLST ##
  394.  Will clear all the presets.
  395.  
  396.  ## LOAD PLST ##
  397.  Will load the presetlist from a file called "PLST". This file should be
  398.  placed in the PTdir (See setup2).
  399.  
  400.  ## SAVE PLST ###
  401.  Will save the presetlist as a file called "PLST" to the current PTdir.
  402.  
  403.  ## PRINT PLST ##
  404.  Will print the presetlist to the current print path, shown on the
  405.  setup-screen.
  406.  
  407.  ## PLST ##
  408.  Will go to the PLST-screen!
  409.  
  410.  ## T(OP) ##
  411.  Will put you at the top of the preset-list.Holding the right mousebutton
  412.  will put you at the previous character in the preset-list.
  413.  
  414.  ## B(OTTOM) ##
  415.  Will put you at the bottom of the preset-list.Holding the right mousebutton
  416.  will put you at the next character in the preset-list.
  417.  
  418.  
  419.  
  420.                 SAMPLER
  421.                 -------
  422.  Editing
  423.  -------
  424.  When editing a sample, use the mouse to set the cursorline and to mark
  425.  ranges.
  426.  
  427.  ## WAVEFORM ##
  428.  Will play the full sample with loops.
  429.  
  430.  ## DISPLAY ##
  431.  Will play the part of the sample being shown on screen.
  432.  
  433.  ## RANGE ##
  434.  Will play the marked range.
  435.  
  436.  ## STOP ##
  437.  Will stop all playing of samples.
  438.  
  439.  ## SHOW RANGE ##
  440.  Will magnify the current range and display it.
  441.  
  442.  ## SHOW ALL ##
  443.  Will display the whole sample.
  444.  
  445.  ## BEG ##
  446.  Will put the cursorline at the beginning of the sample.
  447.  
  448.  ## END ##
  449.  Will put the cursorline at the end of the sample.
  450.  
  451.  ## SWAP BUFF(ER) ##
  452.  The swap the current sample with the copy-buffer.
  453.  
  454.  ## ZOOM OUT ##
  455.  Will show double the range you are displaying.
  456.  
  457.  ## RANGE ALL ##
  458.  Will range the part of the sample being displayed on screen.
  459.  
  460.  ## CUT ##
  461.  Will cut away the part of the sample that's marked.
  462.  
  463.  ## COPY ##
  464.  Will copy the marked range to the copy-buffer.
  465.  
  466.  ## PASTE ##
  467.  Will paste the copy-buffer into the current sample.
  468.  
  469.  
  470.  The volume box
  471.  --------------
  472.  Set the "FROM" and "TO" volume percentages by using the sliders,
  473.  or just type in any number you please (from 0 to 200) in the
  474.  percentage boxes to the right.
  475.  
  476.  ## NORMALIZE ##
  477.  Will find the highest volume settings possible (without clipping).
  478.  
  479.  ## CANCEL ##
  480.  Will exit the volume box.
  481.  
  482.  ## \ ##
  483.  Will set the percentages 100%-0%
  484.  
  485.  ## / ##
  486.  Will set the percentages 0%-100%
  487.  
  488.  ## - ##
  489.  Will set the percentages 100%-100%
  490.  
  491.  ## RAMP ##
  492.  Will ramp (calculate) the volume!
  493.  
  494.  ## TUNETONE ##
  495.  Will create a sinus sound, which you can tune your samples after.
  496.  See setup 2 help for details.
  497.  
  498.  ## SAMPLE ##
  499.  Will first enter the monitor screen. Now click right button to sample,
  500.  left to exit.
  501.  
  502.  ## NOTE ##
  503.  This is the note to sample on. Range is C-1 to B-3.
  504.  
  505.  ## RESAMPLE ##
  506.  Here's a step-by-step explanation:
  507.  
  508.  1. Turn on the tuning tone.
  509.  2. Use the keyboard to find what note it is. Use finetune if needed.
  510.  3. Enter the note in the "Note:" box to the right.
  511.  4. Press resample!
  512.  
  513.  ## NOTE ##
  514.  This is what note to resample to.
  515.  
  516.  ## DISP(LAY) ##
  517.  This is the length of the part of the sample being shown on screen.
  518.  
  519.  ## LOOP ON/OFF ##
  520.  This is for turning loops on/off without having to fiddle with the
  521.  repeat and replen gadgets.
  522.  
  523.  ## EXIT ##
  524.  Exits the sampler screen.
  525.  
  526.  
  527.  
  528.                 SETUP 1
  529.                 -------
  530.  The setup screens were provided so that PT users could set up their own
  531.  personal environment. We hope we have satisfied most of you. You've got 8
  532.  on/off toggles, a split keyboard editor, a color palette and lots
  533.  more. Choose what you want, and use "Save Config" to save your environ-
  534.  ment. On the next screen is a list of what will be saved in the config
  535.  file.
  536.  
  537.  This will be saved in the config file:
  538.  --------------------------------------
  539.  Songs/Modules/Samples/Tracks/Patterns and Print paths, Colors, Keyrepeat
  540.  Song/Module/Sample/Track/Pattern Savemode, The 16 On/Off toggles, Split
  541.  Keyboard data, Keyrepeat, Accidental, The eight external dos commands, 
  542.  Max PLST entries, Multikey channeltable, Effectmacros, CIA/VB timing
  543.  Tempo&Speed, DMA wait and Tunetone+Volume.
  544.  
  545.  You can have up to 256 different config files. They will be saved
  546.  as "PT.config-00", "PT.config-01" and so on. Set the confignumber
  547.  in the "cnfig" box.
  548.  
  549.  ## LOAD CONFIG ##
  550.  Will load the selected config file.
  551.  
  552.  ## SAVE CONFIG ##
  553.  Will save the selected config file.
  554.  
  555.  ## RESET ALL ##
  556.  Will set the original PT defaults and colors.
  557.  
  558.  ## MULTI ##
  559.  This table is used with the multi keyboard option. The four numbers repre-
  560.  sent what channel each channel will jump to next. 1-2, 2-3, 3-4 and so on.
  561.  
  562.  ## THE DOT ##
  563.  The gadget with a dot and a textline can be used to execute dos commands.
  564.  Each of the 8 commands can be up to 31 letters long. Pressing the dot will
  565.  browse through the commands. Holding the right button and pressing it will
  566.  execute the command. Note that PT needs the command "run" to execute the
  567.  other commands. This is because of commodore's stupid programming of the
  568.  dos library function "execute". Type "endcli" to go back to Protracker.
  569.  
  570.  ## THE COLOR PALETTE ##
  571.  The color palette is simple to use. Just select a color, and use the R,
  572.  G and B sliders to set the color.
  573.  
  574.  ## UNDO ##
  575.  Will put back the latest change.
  576.  
  577.  ## CANCEL ##
  578.  Will set the config colors.
  579.  
  580.  ## DEF(AULT) ##
  581.  Will set the original ST colors.
  582.  
  583.  ## SPLIT ##
  584.  You can set 4 splits on the keyboard, each with it's own sample, splitpoint
  585.  and transpose. Just type in a sample number and select the key to split
  586.  at by pressing the appropriate one.
  587.  The transpose note for each split is the first note in that split-range.
  588.  Notes below the first split will be played with the current sample.
  589.  Split is great for recording drums, or for playing untuned samples in tune
  590.  (use together with finetune).
  591.  
  592.  ## CLEAR ##
  593.  Will clear the splits.
  594.  
  595.  ## KEYREP(EAT) ##
  596.  The first number is the keyrepeat delay, and the second is the speed.
  597.  
  598.  ## ACCIDENTAL ##
  599.  Simple enough, accidental allows you to select sharp (#) or flat (¡) notes.
  600.  This will not be saved with the song!
  601.  
  602.  ## PRINT SONG ##
  603.  Will print the song to the path shown below the "Print Song" gadget.
  604.  The print path can be 31 chars long.
  605.  
  606.  ## SPLIT ON/OFF ##
  607.  Toggles between normal and split keyboard.
  608.  
  609.  ## FILTER ON/OFF ##
  610.  Toggles the audiofilter / PowerLED.
  611.  (Not available on all Amigas)
  612.  
  613.  ## TRANS(POSE)DEL(ETE) ON/OFF ##
  614.  When on, notes transposed out of range will be deleted.
  615.  
  616.  ## SHOWDEC(IMAL) ##
  617.  When on, Freemem, Tunemem, and filelengths will be shown in decimal.
  618.  
  619.  ## AUTODIR ON/OFF ##
  620.  When on, Protracker dirs the current directory path automatically.
  621.  
  622.  ## AUTOEXIT ON/OFF ##
  623.  When on, Protracker will automatically exit from the file requester when
  624.  loading a song,module,track or pattern.
  625.  
  626.  ## MOD. ONLY ON/OFF ##
  627.  When on, Protracker will only show modules beginning with "mod.".
  628.  
  629.  ## MIDI ON/OFF ##
  630.  Enables midi input (see midi help).
  631.  
  632.  ## 2 ##
  633.  Will enter SETUP 2.
  634.  
  635.  
  636.  
  637.                 SETUP 2
  638.                 -------
  639.  
  640.  ## TIMING ##
  641.  We included this so that American  users also could enjoy Protracker,
  642.  and wouldn't have to use sonix or any other terrible music program...
  643.  
  644.  You can choose between CIA or Vblank timing. Vblank is the timing-method
  645.  soundtrackers have been using since the dawn of time, while CIA is a much
  646.  better and accurate timing with the tempo measured in beats per minute.
  647.  Using Vblank on NTSC amigas will cause the song to play 20% faster.
  648.  With CIA, there's no difference.
  649.  
  650.  ## TEMPO ##
  651.  This is where you set your default CIA timing tempo. Range: 32-255.
  652.  
  653.  ## SPEED ##
  654.  This is where you set your default Vblank timing speed. Range: 01-FF.
  655.  
  656.  ## COPPER EDITOR ##
  657.  The copper editor is for altering the colors of the VU-meters and the
  658.  spectrum analyzer to your own liking. Select a color by clicking somewhere
  659.  within the coppered stripe. Now use the R, G and B sliders to
  660.  alter the color.
  661.  
  662.  ## SPREAD ##
  663.  Will create an even gradient between the current color and the one you
  664.  click on next.
  665.  
  666.  ## ARROWS ##
  667.  Will rotate the whole copper stripe in the Y-axis (up/down).
  668.  
  669.  ## UNDO, CANCEL and DEF(AULT) ##
  670.  Will work just like in the palette in SETUP 1.
  671.  
  672.  ## MODS ##
  673.  This is where you set your default modules path.
  674.  
  675.  ## SONGS ##
  676.  This is where you set your default songs path.
  677.  
  678.  ## SAMPL(ES) ##
  679.  This is where you set your default sample path.
  680.  
  681.  ## PTDIR ##
  682.  This is the path for the helpfile, the PLST and the PT configfile(s).
  683.  
  684.  ## MAX PLST ##
  685.  This is the maximum number of presets in your presetlist.
  686.  
  687.  ## DMA WAIT ##
  688.  Use this on fast amigas to slow down the DMA enough to not miss any notes.
  689.  If you set a too low value, you will miss some of the low notes!
  690.  If you set a too high value, everything will be slowed down.
  691.  300 or a little less is ok on a normal A500 7.09 MHz (PAL).
  692.  900 (approx.) is ok on an A3000 running at 25Mhz.
  693.  
  694.  ## TUNING TONE ##
  695.  The tuning tone is for use with the sample editor. The note is what note
  696.  to play the tuning tone at, and the number is the volume.
  697.  
  698.  ## SALVAGE ##
  699.  Doesn't work..YET..sorry...
  700.  
  701.  ## <- DEFAULT ##
  702.  Will put back the default for everything in the middle column.
  703.  
  704.  ## OVERRIDE ##
  705.  When on, PT will ignore any paths or disknames when loading a song
  706.  or module. All the samples will be loaded from the current sample
  707.  path.
  708.  
  709.  ## NOSAMPLES ##
  710.  When on, PT won't load the samples when loading a song or module.
  711.  
  712.  ## BLANKZERO ##
  713.  When on, PT won't show the first zero in the samplenumber.
  714.  
  715.  ## SHOW DIRS ##
  716.  When on, directories will be shown in Disk Op.
  717.  
  718.  ## SHOW PUBL(IC) ##
  719.  When on, PT will show all free memory, not just chip-mem.
  720.  
  721.  ## CUT TO BUFF(ER) ##
  722.  When on, all samples cut in the sample editor will to put in the
  723.  copy-buffer.
  724.  
  725.  ## LOAD LOOP ##
  726.  When on, PT will load loops from IFF-samples.
  727.  
  728.  ## SLOW MODE ##
  729.  When on, text editing, gadget-repeats, etc. will go much slower. Use this
  730.  if you have a 25 MHz A3000 or any other fast computer. We will try to do
  731.  an automatic speed check in the next version (1.2).
  732.  
  733.  ## 1 ##
  734.  Will enter SETUP 1.
  735.  
  736.  
  737.  
  738.                  MIDI
  739.                  ----
  740.  Midi routines in Protracker 2.1 are still very limited. Midi in should
  741.  work ok, though. To activate midi, you'll have to turn it on on the
  742.  setup1 screen. Use the three upper octaves on your synthesizer to play
  743.  notes. Some keys in the lowest octave can be used to play/stop/record etc.
  744.  
  745.  We might fix better midi support in later versions of Protracker, but so
  746.  far, this is uncertain... Read the PT.ReadMe! file for more info.
  747.  
  748.  
  749.  
  750.                 EDIT OP.
  751.                 --------
  752.  
  753.  The edit op. screens were just a handy way for us to implement all the new
  754.  functions we had thought of. There are three screens, and you can browse
  755.  through them by pressing the edit op.  gadget more than once, or select one
  756.  by clicking on the numbers 1-3.
  757.  
  758.  To exit edit op., click on the gadget labeled "E" or press ESC.
  759.  
  760.  
  761.  Edit op. Screen 1:
  762.  
  763.  ## TRANSPOSING ##
  764.  
  765.  What is transposing ?
  766.  
  767.  Transposing lets you shift the pitch of the notes up or down.
  768.  E.g. Change a C-3 to a C#3.
  769.  
  770.  In comparison to other trackers, Protracker lets you transpose in just
  771.  about every way you can imagine. You can transpose either the current
  772.  sample or all the samples in a track or pattern.
  773.  
  774.  To the right of the title bar is a small box with the letter "S" or "A".
  775.  
  776.  S - Only the current sample will be transposed.
  777.  A - All the samples from $00-$1F will be transposed. V1.1: Now bugfree!
  778.  
  779.  To toggle between the two, click on the edit op. title bar.
  780.  
  781.  If the setup toggle "TransDel" is on, all the notes transposed out of range
  782.  (C-1 to B-3) will be deleted. If not, they will not be transposed.
  783.  
  784.  
  785.  Edit op. screen 2: (Record)
  786.  
  787.  ## RECORD ##
  788.  PATT - Record current pattern only.
  789.  SONG - When recording, PT will move through the patterns in the
  790.         song, just like normal play.
  791.  
  792.  ## QUANTIZE ##
  793.  Will move the notes you record to every n'th slot. Entering 00 will
  794.  turn off the quantizing, and the notes you play will always be
  795.  inserted at the patternposition you are at. Entering 01 will quantize
  796.  the notes the the nearest slot according to the speed. i.e. if you
  797.  play a note after the first half has been played, it will be quantized
  798.  to the slot below. Entering a value like 8 will quantize to every 8th
  799.  note, and so on. Got that?
  800.  
  801.  ## METRO(NOME) ##
  802.  The first number is the speed of the metronome, and the second is the
  803.  channel to play it on. The Sample used for metronomes is always sample
  804.  $1F. Load your own favourite metronome sample. The metronome will always
  805.  be played at C-3, but you can still change the volume and loop values.
  806.  To turn off the metronome, just set the speed or channel to 00.
  807.  V2.1: The metronome has a master toggle, ALT+M.
  808.  
  809.  ## KEYS ##
  810.  When MULTI, PT will jump to another channel after you play a note on the
  811.  keyboard. This makes it possible to play two or more notes at the same
  812.  time (very useful with midi). On the setup screen you can choose what
  813.  channel to jump to after playing a note.
  814.  
  815.  
  816.  Edit Op. screen 2: (Samples)
  817.  
  818.  To the right of the title bar is a small box with the letter "T", "P"
  819.  or "S".
  820.  
  821.  T - Copy & Exchange apply to current track only.
  822.  P - Copy & Exchange will affect the the whole pattern.
  823.  S - Copy & Exchange will apply to the real samples in memory.
  824.  
  825.  To toggle between the two, click on the edit op. title bar.
  826.  
  827.  ## DELETE ##
  828.  Will delete all notes with the current sample in current track or whole
  829.  pattern.
  830.  
  831.  ## KILL ##
  832.  Will kill the current sample. That is, remove it from memory and reset
  833.  all sample settings. It will not be deleted from the track or pattern.
  834.  You can also use the period (.) key on the numeric keyboard to invoke
  835.  this function.
  836.  
  837.  ## EXCHGE (EXCHANGE) ##
  838.  Will exchange the samplenumber shown in the "FROM" gadget with the sample-
  839.  number in the "TO" gadget and vice versa. "T" or "P" selects track or
  840.  pattern. "S" exchanges the samples.
  841.  
  842.  ## MOVE ##
  843.  Will move the samplenumber shown in the "FROM" gadget to the sample-
  844.  number in the "TO" gadget.
  845.  
  846.  
  847.  Edit Op. screen 3: (Sample Editor)
  848.  
  849.  To the right of the title bar is a small box with the letter "H" or "C".
  850.  
  851.  H - Will halve the volume when mixing and echoing to avoid clipping.
  852.  C - Will not halve the volume. The sample may be clipped.
  853.  
  854.  To toggle between the two, click on the edit op. title bar.
  855.  
  856.  ## MIX ##
  857.  Will mix one sample with another. PT asks you which two samples to be
  858.  mixed, and where to put the result.
  859.  
  860.  Holding the right button and pressing mix will mix the current sample with
  861.  itself. You can offset the sample by setting a position in the "pos" gadg.
  862.  If you set "mod" to a non-zero value, the sample will also be modulated.
  863.  
  864.  ## ECHO ##
  865.  Will create a echo effect on the current sample. Use "pos" to set the
  866.  delay time of the echo. If you want more room to echo in, just turn up
  867.  the length of the sample.
  868.  
  869.  ## BOOST ##
  870.  Will turn up the treble of the sample. Use this on hi-hats and snares!
  871.  
  872.  ## FILTER ##
  873.  Will Delta-filter the sample. Use this on noisy basses.
  874.  
  875.  ## X-FADE ##
  876.  Will crossfade the sample (mix with itself, backwards). Handy for looping
  877.  samples that are hard to loop.
  878.  
  879.  ## BACKWD (Backwards) ##
  880.  Will turn the sample backwards!
  881.  
  882.  ## UPSAMPLE ##
  883.  Will remove every second byte of the sample, halving the length and
  884.  shifting the pitch one octave up.
  885.  
  886.  ## DOWNSAMPLE ##
  887.  Will double every byte of the sample, doubling the length, and shifting
  888.  the pitch one octave down. If you downsample samples longer than $7FFE,
  889.  you will lose the end of them.
  890.  
  891.  ## POS ##
  892.  This is just an offset in the sample, used for a lot of things.This one
  893.  has a numbergadget as well.Holding the right mousebutton while pressing
  894.  the numbergadget will zero the value.
  895.  
  896.  ## MOD ##
  897.  This is used for modulation. Press "MOD" to modulate the current sample.
  898.  Holding the right button while pressing the numbergadget will zero the
  899.  value.
  900.  
  901.  ## CUTBEG(INNING) ##
  902.  Will chop the number of bytes set in the "POS" gadget off the beginning of
  903.  the sample.
  904.  
  905.  ## FU (Fade Up) ##
  906.  Will fade the volume from 0 to 100%. Use "POS" to select where in the
  907.  sample to fade up to.
  908.  
  909.  ## FD (Fade Down) ##
  910.  Will fade the volume from 100 to 0%. Use "POS" to select where in the
  911.  sample to fade down from.
  912.  
  913.  ## VOL ##
  914.  With this you can change the "real" volume of the sample. Just set a
  915.  percentage and press "VOL".VOL has a numbergadget.Holding the right
  916.  button while pressing it will set the value to 100%.
  917.  
  918.  Edit Op.3 is now intended to be used with the new sample-editor. If a
  919.  range is marked, some of the functions apply to the range only. If there's
  920.  no range marked, the functions will affect the whole sample. You may also
  921.  set "POS" by clicking on the sample and setting the cursor-line.
  922.  
  923.  
  924.  
  925.                 EFFECT COMMANDS
  926.                 ---------------
  927.  
  928.  Effect commands on Protracker should
  929.  be compatible with all other trackers.
  930.  
  931.  0 - None/Arpeggio      8 - * NOT USED *
  932.  1 - Portamento Up      9 - SampleOffset
  933.  2 - Portamento Down    A - VolumeSlide
  934.  3 - TonePortamento     B - PositionJump
  935.  4 - Vibrato            C - Set Volume
  936.  5 - ToneP + VolSlide   D - PatternBreak
  937.  6 - Vibra + VolSlide   E - Misc. Cmds
  938.  7 - Tremolo            F - Set Speed
  939.  
  940.                 E - COMMANDS
  941.                 ------------
  942.  
  943.  The E command has been altered to contain more commands than one.
  944.  
  945.  E0- Filter On/Off      E8- * NOT USED *
  946.  E1- Fineslide Up       E9- Retrig Note
  947.  E2- Fineslide Down     EA- FineVol Up
  948.  E3- Glissando Control  EB- FineVol Down
  949.  E4- Vibrato Control    EC- NoteCut
  950.  E5- Set Finetune       ED- NoteDelay
  951.  E6- Patternloop        EE- PatternDelay
  952.  E7- Tremolo Control    EF- Invert Loop
  953.  
  954.  
  955.  
  956.  Cmd 0. Arpeggio [Range:$0-$F/$0-$F]
  957.  -----------------------------------
  958.  Usage: $0 + 1st halfnote add
  959.            + 2nd halfnote add
  960.  
  961.  Arpeggio is used to simulate chords. This is done by rapidly changing the
  962.  pitch between 3(or 2) different notes. It sounds very noisy and grainy on
  963.  most samples, but ok on monotone ones.
  964.  
  965.  Example: C-300047  C-major chord: (C+E+G  or C+4+7 halfnotes)
  966.  
  967.           C-300037  C-minor chord: (C+D#+G or C+3+7 halfnotes)
  968.  
  969.  
  970.  
  971.  Cmd 1. Portamento up [Speed:$00-$FF]
  972.  ------------------------------------
  973.  Usage: $1 + portamento speed
  974.  
  975.  Portamento up will simply slide the sample pitch up. You can NOT slide
  976.  higher than B-3! (Period 113)
  977.  
  978.  Example: C-300103  1 is the command, 3 is the portamentospeed.
  979.  
  980.  NOTE: The portamento will be called as many times as the speed of the song.
  981.  This means that you'll sometimes have trouble sliding accuratly. If you
  982.  change the speed without changing the sliderates, it will sound bad...
  983.  
  984.  
  985.  
  986.  Cmd 2. Portamento down [Speed:$00-FF]
  987.  -------------------------------------
  988.  Usage: $2 + portamento speed
  989.  
  990.  Just like command 1, except that this one slides the pitch down instead.
  991.  (Adds to the period).
  992.  
  993.  You can NOT slide lower than C-1! (Period 856)
  994.  
  995.  Example: C-300203  2 is the command, 3 is the portamentospeed.
  996.  
  997.  
  998.  
  999.  Cmd 3. Tone-portamento [Speed:$00-$FF]
  1000.  --------------------------------------
  1001.  Usage: Dest-note + $3 + slidespeed
  1002.  
  1003.  This command will automatically slide from the old note to the new.
  1004.  You don't have to worry about which direction to slide, you need only set
  1005.  the slide speed. To keep on sliding, just select the command $3 + 00.
  1006.  
  1007.  Example: A-200000  First play a note.
  1008.           C-300305  C-3 is the note to slide to, 3 the command,
  1009.                     and 5 the speed.
  1010.  
  1011.  
  1012.  
  1013.  Cmd 4. Vibrato [Rate:$0-$F,Dpth:$0-$F]
  1014.  --------------------------------------
  1015.  Usage: $4 + vibratorate + vibratodepth
  1016.  
  1017.  Example: C-300481  4 is the command, 8 is the speed of the vibrato,
  1018.                     and 1 is the depth of the vibrato.
  1019.  
  1020.  To keep on vibrating, just select the command $4 + 00. To change the
  1021.  vibrato, you can alter the rate, depth or both. Use command E4- to
  1022.  change the vibrato-waveform.
  1023.  
  1024.  
  1025.  
  1026.  Cmd 5. ToneP + Volsl [Spd:$0-$F/$0-$F]
  1027.  --------------------------------------
  1028.  Usage: $5 + upspeed + downspeed
  1029.  
  1030.  This command will continue the current toneportamento and slide the volume
  1031.  at the same time. Compatible with Noisetracker 2.0.
  1032.  
  1033.  Example: C-300503  3 is the speed to turn the volume down.
  1034.  
  1035.           C-300540  4 is the speed to slide it up.
  1036.  
  1037.  
  1038.  
  1039.  Cmd 6. Vibra + Volsl [Spd:$0-$F/$0-$F]
  1040.  --------------------------------------
  1041.  Usage: $6 + upspeed + downspeed
  1042.  
  1043.  This command will continue the current vibrato and slide the volume at the
  1044.  same time. Compatible with Noisetracker 2.0.
  1045.  
  1046.  Example: C-300605  5 is the speed to turn the volume down.
  1047.  
  1048.           C-300640  4 is the speed to slide it up.
  1049.  
  1050.  
  1051.  
  1052.  Cmd 7. Tremolo [Rate:$0-$F,Dpth:$0-$F]
  1053.  --------------------------------------
  1054.  Usage: $7 + tremolorate + tremolodepth
  1055.  
  1056.  Tremolo vibrates the volume.
  1057.  
  1058.  Example: C-300794  7 is the command, 9 is the speed of the tremolo,
  1059.                     and 4 is the depth of the tremolo.
  1060.  
  1061.  To keep on tremoling, just select the command $7 + 00. To change the
  1062.  tremolo, you can alter the rate, depth or both. Use command E7- to
  1063.  change the tremolo-waveform.
  1064.  
  1065.  
  1066.  
  1067.  Cmd 9. Set SampleOffset [Offs:$00-$FF]
  1068.  --------------------------------------
  1069.  Usage: $9 + Sampleoffset
  1070.  
  1071.  This command will play from a chosen position in the sample, and not from
  1072.  the beginning. The two numbers equal the two first numbers in the length
  1073.  of the sample. Handy for speech samples.
  1074.  
  1075.  Example: C-300923  Play sample from offset $2300.
  1076.  
  1077.  
  1078.  
  1079.  Cmd A. Volumeslide [Speed:$0-$F/$0-$F]
  1080.  --------------------------------------
  1081.  Usage: $A + upspeed + downspeed
  1082.  
  1083.  Example: C-300A05  5 is the speed to turn the volume down.
  1084.  
  1085.           C-300A40  4 is the speed to slide it up.
  1086.  
  1087.  NOTE: The slide will be called as many times as the speed of the song.
  1088.  The slower the song, the more the volume will be changed on each note.
  1089.  
  1090.  
  1091.  
  1092.  Cmd B. Position-jump [Pos:$00-$7F]
  1093.  ----------------------------------
  1094.  Usage: $B + position to continue at
  1095.  
  1096.  Example: C-300B01  B is the command, 1 is the position to
  1097.                     restart the song at.
  1098.  
  1099.  This command will also perform a pattern-break (see 2 pages below).
  1100.  
  1101.  You can use this command instead of restart as on Noisetracker, but you
  1102.  must enter the position in hex!
  1103.  
  1104.  
  1105.  
  1106.  Cmd C. Set volume [Volume:$00-$40]
  1107.  ----------------------------------
  1108.  Usage: $C + new volume
  1109.  
  1110.  Well, this old familiar command will set the current volume to your own
  1111.  selected. The highest volume is $40. All volumes are represented in hex.
  1112.  (Programmers do it in hex, you know!)
  1113.  
  1114.  Example: C-300C10  C is the command, 10 is the volume (16 decimal).
  1115.  
  1116.  
  1117.  
  1118.  Cmd D. Pattern-break [Pattern-pos:00-63, decimal]
  1119.  -------------------------------------------------
  1120.  Usage: $D + pattern-position
  1121.  
  1122.  This command just jumps to the next song-position, and continues play
  1123.  from the patternposition you specify.
  1124.  
  1125.  Example: C-300D00  Jump to the next song-position and continue play
  1126.                     from patternposition 00.
  1127.       Or: C-300D32  Jump to the next song-position and continue play
  1128.                     from patternposition 32 instead.
  1129.  
  1130.  
  1131.  
  1132.  Cmd E0. Set filter [Range:$0-$1]
  1133.  --------------------------------
  1134.  Usage: $E0 + filter-status
  1135.  
  1136.  This command jerks around with the sound-filter on some A500 + A2000.
  1137.  All other Amiga-users should keep out of playing around with it.
  1138.  
  1139.  Example: C-300E01  disconnects filter (turns power LED off)
  1140.  
  1141.           C-300E00  connects filter (turns power LED on)
  1142.  
  1143.  
  1144.  
  1145.  Cmd E1. Fineslide up [Range:$0-$F]
  1146.  ----------------------------------
  1147.  Usage: $E1 + value
  1148.  
  1149.  This command works just like the normal portamento up, except that
  1150.  it only slides up once. It does not continue sliding during the length
  1151.  of the note.
  1152.  
  1153.  Example: C-300E11  Slide up 1 at the beginning of the note.
  1154.  
  1155.  (Great for creating chorus effects)
  1156.  
  1157.  
  1158.  
  1159.  Cmd E2. Fineslide down [Range:$0-$F]
  1160.  ------------------------------------
  1161.  Usage: $E2 + value
  1162.  
  1163.  This command works just like the normal portamento down, except that
  1164.  it only slides down once. It does not continue sliding during the length
  1165.  of the note.
  1166.  
  1167.  Example: C-300E26  Slide up 6 at the beginning of the note.
  1168.  
  1169.  
  1170.  
  1171.  Cmd E3. Glissando Ctrl [Range:$0-$1]
  1172.  ------------------------------------
  1173.  Usage: $E3 + Glissando-Status
  1174.  
  1175.  Glissando must be used with the tone-portamento command. When glissando is
  1176.  activated, toneportamento will slide a halfnote at a time, instead of a
  1177.  straight slide.
  1178.  
  1179.  Example: C-300E31  Turn Glissando on.
  1180.  
  1181.           C-300E30  Turn Glissando off.
  1182.  
  1183.  
  1184.  
  1185.  Cmd E4. Set vibrato waveform [Range:$0-$3]
  1186.  ------------------------------------------
  1187.  Usage: $E4 + vibrato-waveform
  1188.  
  1189.  Example: C-300E40  Set sine(default)
  1190.                E44  Don't retrig WF
  1191.           C-300E41  Set Ramp Down
  1192.                E45  Don't retrig WF
  1193.           C-300E42  Set Squarewave
  1194.                E46  Don't retrig WF
  1195.           C-300E43  Set Random
  1196.                E47  Don't retrig WF
  1197.  
  1198.  
  1199.  
  1200.  Cmd E5. Set finetune [Range:$0-$F]
  1201.  ----------------------------------
  1202.  Usage: $E5 + finetune-value
  1203.  
  1204.  Example: C-300E51  Set finetune to 1.
  1205.  
  1206.  Use these tables to figure out the finetune-value.
  1207.  
  1208.  Finetune: +7 +6 +5 +4 +3 +2 +1  0
  1209.     Value:  7  6  5  4  3  2  1  0
  1210.  
  1211.  Finetune: -1 -2 -3 -4 -5 -6 -7 -8
  1212.     Value:  F  E  D  C  B  A  9  8
  1213.  
  1214.  
  1215.  
  1216.  Cmd E6. PatternLoop [Loops:$0-$F]
  1217.  ----------------------------------
  1218.  Usage: $E6 + number of loops
  1219.  
  1220.  This command will loop a part of a pattern.
  1221.  
  1222.  Example: C-300E60  Set loopstart.
  1223.  
  1224.           C-300E63  Jump to loop 3 times before playing on.
  1225.  
  1226.  
  1227.  
  1228.  Cmd E7. Set tremolo waveform [Range:$0-$3]
  1229.  ------------------------------------------
  1230.  Usage: $E7 + tremolo-waveform
  1231.  
  1232.  Example: C-300E70  Set sine(default)
  1233.                E74  Don't retrig WF
  1234.           C-300E71  Set Ramp Down
  1235.                E75  Don't retrig WF
  1236.           C-300E72  Set Squarewave
  1237.                E76  Don't retrig WF
  1238.           C-300E73  Set Random
  1239.                E77  Don't retrig WF
  1240.  
  1241.  
  1242.  
  1243.  Cmd E9. Retrig note [Value:$0-$F]
  1244.  ---------------------------------
  1245.  Usage: $E9 + Tick to Retrig note at.
  1246.  
  1247.  This command will retrig the same note before playing the next. Where to
  1248.  retrig depends on the speed of the song. If you retrig with 1 in speed 6
  1249.  that note will be trigged 6 times in one note slot. Retrig on hi-hats!
  1250.  
  1251.  Example: C-300F06  Set speed to 6.
  1252.           C-300E93  Retrig at tick 3 out of 6.
  1253.  
  1254.  
  1255.  
  1256.  Cmd EA. FineVolsl up [Range:$0-$F]
  1257.  ----------------------------------
  1258.  Usage: $EA + value
  1259.  
  1260.  This command works just like the normal volumeslide up, except that
  1261.  it only slides up once. It does not continue sliding during the length
  1262.  of the note.
  1263.  
  1264.  Example: C-300EA3  Slide volume up 1 at the beginning of the note.
  1265.  
  1266.  
  1267.  
  1268.  Cmd EB. FineVolsl down [Range:$0-$F]
  1269.  ------------------------------------
  1270.  Usage: $EB + value
  1271.  
  1272.  This command works just like the normal volumeslide down, except that
  1273.  it only slides down once. It does not continue sliding during the length
  1274.  of the note.
  1275.  
  1276.  Example: C-300EB6  Slide volume down 6 at the beginning of the note.
  1277.  
  1278.  
  1279.  
  1280.  Cmd EC. Cut note [Value:$0-$F]
  1281.  ------------------------------
  1282.  Usage: $EC + Tick to cut note at.
  1283.  
  1284.  This command will cut the note at the selected tick, creating
  1285.  extremely short notes.
  1286.  
  1287.  Example: C-300F06  Set speed to 6.
  1288.           C-300EC3  Cut at tick 3 out of 6.
  1289.  
  1290.  Note that the note is not really cut, the volume is just turned down.
  1291.  
  1292.  
  1293.  
  1294.  Cmd ED. NoteDelay [Value:$0-$F]
  1295.  -------------------------------
  1296.  Usage: $ED + ticks to delay note.
  1297.  
  1298.  This command will delay the note to the selected tick.
  1299.  
  1300.  Example: C-300F06  Set speed to 6.
  1301.           C-300ED3  Play note at tick 3 out of 6.
  1302.  
  1303.  If you use ED0, the note will be delayed a little anyway.
  1304.  You can play the same note on two channels, delay one, and get a
  1305.  nice flanging effect.
  1306.  
  1307.  
  1308.  
  1309.  Cmd EE. PatternDelay [Notes:$0-$F]
  1310.  ----------------------------------
  1311.  Usage: $EE + notes to delay pattern.
  1312.  
  1313.  This command will delay the pattern the selected numbers of notes.
  1314.  
  1315.  Example: C-300EE8  Delay pattern 8 notes before playing on.
  1316.  
  1317.  All other effects are still active when the pattern is being delayed.
  1318.  
  1319.  
  1320.  
  1321.  Cmd EF. Invert Loop [Speed:$0-$F]
  1322.  ---------------------------------
  1323.  Usage: $EF + Invertspeed
  1324.  
  1325.  This command will need a short loop ($10,20,40,80 etc. bytes) to work.
  1326.  It will invert the loop byte by byte. Sounds better than funkrepeat...
  1327.  
  1328.  Example: C-300EF8 Set invspeed to 8.
  1329.  
  1330.  To turn off the inverting, set invspeed to 0, or press ctrl + Z.
  1331.  
  1332.  This effect will trash the sample, and will probably be removed in
  1333.  the next version.
  1334.  
  1335.  
  1336.  
  1337.  Cmd F. Set speed [Speed:$00-$FF]
  1338.  --------------------------------
  1339.  Usage: $F + speed
  1340.  
  1341.  This command will set the speed of the song.
  1342.  
  1343. Vblank: Range 01-FF - Normal timing
  1344.  
  1345.    CIA: Range 01-1F - Set vblank speeds
  1346.                       with CIA timing.
  1347.    CIA: Range 20-FF - Set BPM speeds,
  1348.                       range 32-255.
  1349.   Both: Range 00    - STOP song.
  1350.  
  1351.  
  1352.  
  1353.                 KEYBOARD
  1354.                 --------
  1355.  The keymap on Protracker is a standard US keymap. The font has been enhanced
  1356.  and redrawn a little, so you now have a lot more special characters than
  1357.  before. Remember to always use the left shift and alt, as the right ones
  1358.  are used for other things.
  1359.  
  1360.  High notekeys:  2 3   5 6 7   9 0   =
  1361.                 Q W E R T Y U I O P [ ]
  1362.  
  1363.  Low notekeys:    S D   G H J   L ;
  1364.                  Z X C V B N M , . /
  1365.  
  1366.  F1 - Choose lo octave(From C-1 to G-3)
  1367.  F2 - Choose hi octave(From C-2 to B-3)
  1368.  
  1369.       F3 - Cut   (sample)
  1370.       F4 - Copy  (sample)
  1371.       F5 - Paste (sample)
  1372.  
  1373.  shft+F3 - Cut track to buffer
  1374.  shft+F4 - Copy track to buffer
  1375.  shft+F5 - Paste track-buffer to track
  1376.  
  1377.   alt+F3 - Cut whole pattern to buffer
  1378.   alt+F4 - Copy whole pattern to buffer
  1379.   alt+F5 - Paste patt-buffer to pattern
  1380.  
  1381.  ctrl+F3 - Cut commands to buffer
  1382.  ctrl+F4 - Copy commands to buffer
  1383.  ctrl+F5 - Paste cmd-buffer to track
  1384.  
  1385.  F6 - Go to patternposition 0
  1386.  F7 - Go to patternposition 16
  1387.  F8 - Go to patternposition 32
  1388.  F9 - Go to patternposition 48
  1389.  F10- Go to patternposition 63
  1390.  
  1391.  shft+F6-F10 - Store current patternposition on selected F-key
  1392.   alt+F6-F10 - Play pattern from the stored patternposition
  1393.  ctrl+F6-F10 - Record from the stored patternposition
  1394.  
  1395. Esc - Exit DiskOp/EditOp/PLST/PsetEd/Setup/Help etc...
  1396.  
  1397.  shft+Return  - Insert blank note at cursorposition and move
  1398.                 the others down. Notes beyond patternposition
  1399.                 63 will be lost!
  1400.  shft+Bckspce - Delete note above cursorposition and move
  1401.                 the others up. You can NOT do this if you're
  1402.                 at patternposition 0!
  1403.  
  1404.  alt+Return    - As above, but with all 4 tracks
  1405.  alt+Backspace - As above, but with all 4 tracks
  1406.  
  1407.  ctrl+Return    - Push cmds one down
  1408.  ctrl+Backspace - Drag cmds one up
  1409.  
  1410.  ctrl+0-9 - Select how many slots PT will jump down each time
  1411.             you insert a note (this is only in Edit-mode)
  1412.  
  1413.   alt+cursor right - patternnumber up
  1414.   alt+cursor left  - patternnumber down
  1415.  shft+cursor right - song-position up
  1416.  shft+cursor left  - song-position down
  1417.  ctrl+cursor left  - samplenumber up
  1418.  ctrl+cursor right - samplenumber down
  1419.  
  1420.  BackwardsSingleQuote (The key over TAB, you know?) - Go to CLI
  1421.  
  1422.       Help - Go to help or plst screen
  1423.  shft+Help - Toggle between Help or PLST on Help key
  1424.  
  1425.  Space - Toggle between Stop/Edit-mode
  1426.  
  1427.  < (beside Z) - Kill DMA & Volumes to 0
  1428.   right Amiga - Play Pattern
  1429.     right Alt - Play Song
  1430.   right Shift - Record
  1431.     Caps Lock - Toggle Keyrepeat on/off
  1432.  
  1433.       Del - Delete note under cursor
  1434.   alt+Del - Delete command only
  1435.  shft+Del - Delete note and command
  1436.  
  1437.  On Numeric pad:
  1438.  
  1439.           0 - Select Sample $0
  1440.     1st row - Select Sample $1-$4
  1441.     2nd row - Select Sample $5-$8
  1442.     3rd row - Select Sample $9-$c
  1443.     4th row - Select Sample $d-$f
  1444.  Just Enter - Select Sample $10
  1445.  
  1446.  Holding Enter + the other keys, will select sample $11-$1F
  1447.  
  1448.  Period (.) - Kill current sample
  1449.  
  1450.  Left Amiga (Plus keys below) - Transposing like in Edit Op. Screen 1
  1451.  
  1452.    Sample/Track        Sample/Pattern
  1453.    ----------------------------------
  1454.    1 - Note Up         2 - Note Up
  1455.    Q - Note Down       W - Note Down
  1456.    A - Octave Up       S - Octave Up
  1457.    Z - Octave Down     X - Octave Down
  1458.  
  1459.    All/Track           All/Pattern
  1460.    -------------------------------
  1461.    3 - Note Up         4 - Note Up
  1462.    E - Note Down       R - Note Down
  1463.    D - Octave Up       F - Octave Up
  1464.    C - Octave Down     V - Octave Down
  1465.  
  1466.       Tab - Move cursor to next track
  1467.  Shft+Tab - Move cursor to prev track
  1468.  
  1469.  ctrl+A - Toggle channel on/off
  1470.  ctrl+B - Mark block
  1471.  ctrl+C - Copy block to buffer
  1472.  ctrl+D - Delete block, drag notes up
  1473.  ctrl+E - expand track
  1474.  ctrl+F - toggle filter on/off
  1475.  ctrl+G - Boost all samples
  1476.  ctrl+H - Transpose block up
  1477.  ctrl+I - Insert block, push notes down
  1478.  ctrl+J - Join-paste block
  1479.  ctrl+K - Kill to end of track
  1480.  ctrl+L - Transpose block down
  1481.  ctrl+M - Toggle multikeyboard on/off
  1482.  ctrl+N - Re-mark last block
  1483.  ctrl+O - Contract track
  1484.  ctrl+P - Paste block
  1485.  ctrl+Q - Unmute all channels
  1486.  ctrl+R - Restore F6-F10 positions
  1487.  ctrl+S - Toggle split keyboard on/off
  1488.  ctrl+T - swap tracks
  1489.  ctrl+U - undo last change
  1490.  ctrl+V - Filter all samples
  1491.  ctrl+W - Polyphonize block
  1492.  ctrl+X - Cut block to buffer
  1493.  ctrl+Y - Backwards block
  1494.  ctrl+Z - Restore Effects
  1495.  
  1496.  shft+0-9 - Store current command on selected key
  1497.   alt+0-9 - Insert command in current track
  1498.  
  1499.   alt+"\" - Copy command above cursor to current patternposition.
  1500.   alt+"=" - Copy command above cursor to current patternposition
  1501.             and add one to the value.
  1502.   alt+"-" - Copy command above cursor to current patternposition
  1503.             and subract one from the value.
  1504.  
  1505.   alt+A - Monitor/Start sampling
  1506.   alt+B - Boost sample
  1507.   alt+C - Toggle channel 3
  1508.   alt+D - Go to Disk Op.
  1509.   alt+E - Go to Edit Op.
  1510.   alt+F - Filter sample
  1511.   alt+I - Toggle AutoinsertEffect on/off
  1512.   alt+K - Delete current sample/track
  1513.   alt+M - Toggle metronome on/off
  1514.   alt+Q - Quit Protracker
  1515.   alt+R - Resample
  1516.   alt+S - Go to Sampler screen
  1517.   alt+T - Tuning Tone
  1518.   alt+V - Toggle channel 4
  1519.   alt+X - Toggle channel 2
  1520.   alt+Y - Save all samples
  1521.   alt+Z - Toggle channel 1
  1522.  
  1523.  alt+shift+M - Set metrochannel to current channel
  1524.  
  1525.       ' - Autoinsertmacro down
  1526.       # - Autoinsertmacro up (The key beside return)
  1527.       \ - Toggle keypad mode (dots!)
  1528.  Return - Step one note forward
  1529.  Backspc - Step 0 note backward
  1530.  Amiga+Backspc - Step 1 note backward
  1531.   Alt+any key on keypad - tune drumpad
  1532.  
  1533.  
  1534.  
  1535.              GENERAL INFO.
  1536.              -------------
  1537.  Making Music
  1538.  ------------
  1539.  Any piece of music written with Protracker is built up from patterns.
  1540.  Each pattern is built up from four tracks, one for each of the amiga's
  1541.  audiochannels.
  1542.  
  1543.  A pattern is 64 lines long. The magnified line is always the one you edit.
  1544.  If you need shorter patterns, use the patternbreak effect command.
  1545.  
  1546.  A track is built up like this:
  1547.  
  1548.      32  C-3 01 C20
  1549.      /   \_/ |/ \_/
  1550.     /    /   |    \
  1551.   Pos Note Sample Effect cmd.
  1552.  
  1553.  The C-3 is the note being played at patternposition 32. 01 is the sample-
  1554.  number, and the three last digits are the effect command, in this case, set
  1555.  volume to $20 (C-Command, 20-Value).
  1556.  
  1557.  Protracker holds a table with info about the sequence in which the patt-
  1558.  erns will be played. With the "Pos" gadget you determine your position in
  1559.  the table. With "Pattern" you define what pattern to play at that position.
  1560.  "Length" defines the total size of the table. The full sequence of Patterns
  1561.  is the Song. A song is built up from up to 64 different patterns, each
  1562.  being played at up to 128 different positions.
  1563.  
  1564.  The small gadgets labeled "I" and "D" are Insert and Delete. With them you
  1565.  can Insert or Delete a position from your song. The length of your song
  1566.  will be adjusted automatically. Remember that the length of your song
  1567.  always must be one more than the last position, since the first position
  1568.  is 0.
  1569.  
  1570.  The "Are you sure ?" requester
  1571.  ------------------------------
  1572.  In addition to the gadgets, you can use "Y" or Return for Yes,
  1573.  and "N" or ESC for No.
  1574.  
  1575.  The Clear requester
  1576.  -------------------
  1577.  In addition to the gadgets you can use "A" for All, "O" for Song, "S" for
  1578.  samples and "C" or ESC for Cancel.
  1579.  
  1580.  The text-input routine
  1581.  ----------------------
  1582.  Now this is really simple. Clicking on a textline will enable you to edit
  1583.  it. Some text lines are longer than they seem, so use the arrowkeys to
  1584.  scroll back and forth in the text. The text input mode is just like an
  1585.  ordinary text editor. You can use backspace, delete, space and such.
  1586.  In text-input mode you can also use the numeric pad for entering numbers.
  1587.  Pressing the right mousebutton will clear the textline and exit the editing.
  1588.  Use ESC or return to just exit.
  1589.  
  1590.  The numbergadgets
  1591.  -----------------
  1592.  Click on them and type in the value(Hex or Dec).ESC or return aborts.
  1593.  
  1594.  Passing arguments from Workbench/CLI
  1595.  ------------------------------------
  1596.  When starting from CLI, you can type a modulename with a pathname(optional)
  1597.  as an argument. The modulename will be added to the modulepath stored in
  1598.  the current config-file.
  1599.  E.g. If the modulepath is ST-00:modules, and you pass crap/mod.fake as an
  1600.  argument, then the module ST-00:modules/crap/mod.fake will be loaded.
  1601.  When starting from Workbench, you can click on a project icon twice and
  1602.  the selected module will be loaded(presuming that the icon's default tool
  1603.  is PT2.1A.The module will be loaded from the modulepath in the current
  1604.  config-file regardless of in which directory the moduleicon is located.
  1605.  That is, you can have all modules in a directory and the icons in another
  1606.  directory to prevent PT from loading all .info files into the file-list
  1607.  when you select LOAD MODULE.
  1608.  Pressing the moduleicon once, and holding shift while double-clicking on
  1609.  the PT2.1A icon also works as above.
  1610.  
  1611.  Tips 'n tricks
  1612.  --------------
  1613.  When inserting, pasting or join-pasting, hold down shift to keep the
  1614.  cursor from jumping to the end of the block. e.g. shft+ctrl+P
  1615.  
  1616.  Holding shift while pressing ctrl+K (kill to end of track) will kill to
  1617.  start of track instead.
  1618.  Holding shift while pressing ctrl+shift-a will solo the current channel.
  1619.  
  1620.  Use Esc or right mousebutton to exit from a lot of things.
  1621.  
  1622.  Effect tips
  1623.  -----------
  1624.  You can set the volume without playing a note. e.g. ---01000
  1625.  This will set the volume for sample 1 without trigging the note.
  1626.  
  1627.  Or try trigging the sample and sliding
  1628.  the volume down. e.g. C-301A08
  1629.                        ---01A08
  1630.                        ---01A08
  1631.  This will create a strange arpeggiato effect, like on "Cream of the earth"
  1632.  by Romeo Knight / RSI.
  1633.  
  1634.  
  1635.  Pointer Colors
  1636.  --------------
  1637.  
  1638.  Gray      - Nothin's happening.
  1639.  Yellow    - Playing song / pattern.
  1640.  Green     - Disk action.
  1641.  Blue      - Edit / record.
  1642.  Magenta   - Waiting for something (text, number or something else).
  1643.  Cyan      - Select entry or delete.
  1644.  Red       - Something went wrong.
  1645.  
  1646.  
  1647.  Drumpad
  1648.  -------
  1649.  Use backspace '\' to toggle modes. One or more dots will appear to
  1650.  the right of the freemem display.
  1651.  
  1652.  No dots: Normal keypad.
  1653.    1 dot: Drumpad.
  1654.   2 dots: Drumpad - Edit/Rec possible.
  1655.  
  1656.  Use Alt + keypad key to set note.
  1657.  
  1658.  
  1659.